home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / extnet10.zip / EXTNET.DOC < prev    next >
Text File  |  1991-11-15  |  6KB  |  127 lines
  1. ExtNet & ExtScan - (c) Copyright 1991 Matt Messier
  2.  
  3. Description
  4. -----------
  5.      The ExtNet package (ExtNet.Exe and ExtScan.Exe) is an addition to the
  6. built-in PCBoard node scan facility.  ExtNet provides extra information
  7. about each node.  The ExtScan program provides the node scan for users while
  8. the ExtNet program maintains the extended node information data file.
  9.  
  10. Configuration
  11. -------------
  12.      ExtScan requires a configuration file.  Only three lines are required in
  13. the configuration file.  They are as follows:
  14.  
  15. Line 1: INTERRUPT or BIOS.  Required by ProKit (with which the ExtScan program
  16.         is written).  Go with INTERRUPT, if that doesn't work try BIOS.  If
  17.         that doesn't work then you've got a problem <Grin>!
  18. Line 2: Path and name of your usernet.dat file.  This should be the same as
  19.         what you have configured in PCBSetup.
  20. Line 3: Path and name of your extnet.dat file.  This is the extended data file
  21.         that ExtNet maintains.  It's a good idea to keep this in the same
  22.         directory as your usernet.dat file.  It doesn't matter where you put
  23.         it, but all nodes should point to the same file.
  24.  
  25. Installation
  26. ------------
  27.      To install ExtNet, run the ExtNet program with the following command
  28. line parameters (Full information on the ExtNet program will be documented
  29. later on in this file)
  30.  
  31. ExtNet <UserNet> <ExtNet> doorid.dat 1 /I
  32.  
  33. where <UserNet> is the path and name of your usernet.dat file
  34.       <ExtNet>  is the path and name of your extnet.dat file.  This should be
  35.                 the same as what you have on line 2 of your extscan config
  36.                 file.
  37.  
  38. This will create the extnet file and format it to the same number of records
  39. as the usernet.dat file.  If you upgrade your PCBoard from a lower version to
  40. a higher version (E3 to E9 for instance), run this again so the ExtNet file
  41. will clean itself up.  This should be done while there are no callers online.
  42.  
  43. Finally, create a door id file.  This is the file that ExtNet will look at to
  44. put in the "Using Door:" description.  This will be explained later.  For each
  45. door id, you must have two lines.  The first is any id you want (no spaces).
  46. This is what you will specify on the command line for extnet.  The second line
  47. is the description that you want to be shown to other users.  This may be up
  48. to 20 characters in length.
  49.  
  50. Using ExtNet
  51. ------------
  52.      ExtNet.Exe takes up to 6 command line parameters.  Only the first 5 are
  53. required for all operations.  They are as follows:
  54.  
  55. Parameter 1: The path and name of your usernet.dat file
  56. Parameter 2: The path and name of your extnet.dat file
  57. Parameter 3: The path and name of your door id data file
  58. Parameter 4: The node number to update
  59. Parameter 5: The function to perform.  This may be any one of the following:
  60.              /I - Initialize the extnet.dat file.  This will clear out all
  61.                   records with nuls, and format it to the correct size.
  62.              /L - Log a user into the system.  This should be called from your
  63.                   $$LOGON.BAT file to tell extnet that someone has just logged
  64.                   onto the system and to show it in the node scan.
  65.              /O - Log a user out of the system.  This should be called from
  66.                   your $$LOGOFF.BAT file to tell extnet that someone has just
  67.                   logged off of the system.  It will fill the record for this
  68.                   node with nuls so no addition information will be displayed
  69.                   in the extended node scan
  70.              /D - Update the "Using Door" setting.  This function optionally
  71.                   uses the 6th command line parameter.  ExtNet will attempt
  72.                   to match the ID given in parameter 6 with a description in
  73.                   your door id data file.  If No parameter 6 is given or no
  74.                   match can be found then the "Using Door" setting will be
  75.                   cleared.
  76. Parameter 6: [Optional]  This is used in conjunction with parameter 5.  It is
  77.              explained with the /D function above.
  78.  
  79. Create a $$LOGON.BAT file to log the user in.  Use parameter 5 function /L.
  80.  
  81. Create a $$LOGOFF.BAT file to log the user out.  Use parameter 5 function /O.
  82.  
  83. In each of your door data files, add two lines that run the ExtNet program.
  84. The first one should be called before the door itself is loaded.  This should
  85. use function /D with a door id for parameter 6.  This will update the extended
  86. status to reflect which door the user is using.  The second line should be
  87. added after the door exits.  Use function /D with no parameter 6 to reflect
  88. the fact that the user has exited the door.
  89.  
  90. Using ExtScan
  91. -------------
  92.      Add a new door to your DOORS.LST file to provide the node scan function
  93. to your callers.  Call it SCAN or something similar.  Make this door SHELL
  94. instead of dump completely to make it seem like it is built into PCBoard.
  95. In the door batch file all you need is the following command:
  96.  
  97. ExtScan <config file> <PCB dir> [<LOCAL>]
  98.  
  99. where <config file> is the path and name of the configuration file for extscan
  100.                     which was described earlier in this document.  This can be
  101.                     the same for all nodes.
  102.       <PCB dir>     is the path of your PCBoard directory.
  103.       [<LOCAL>]     [Optional]  If you want to run the node scan locally then
  104.                     add this parameter to the end.
  105.  
  106. Conclusion
  107. ----------
  108.      There is no required registration fee for ExtNet, but if you happen to
  109. have an extra $5 bill burning a hole in your pocket yelling and screaming to
  110. you to spend it, pop it into your checking account and mail me a check for
  111. registration.  All registrations received are going towards my college
  112. education, so it's for a good cause.  Of course, if you want to send more than
  113. $5, go right ahead! <Grin>  If you're sending money from Canada in check form,
  114. then please add an additional $5 because the banks down here like to charge me
  115. a $5 processing fee (Nice of them, eh?)
  116.  
  117.      Thanks for checking this out ... It's really not as hard as it seems to
  118. set it up and get it working properly ... Future upgrades will most likely be
  119. sent out too as I get more ideas for it.  Enjoy!
  120.  
  121. Oh yeah, my address is:
  122.  
  123. ExtNet Registration
  124. c/o Matt Messier
  125. 3 Loring Drive
  126. Lincoln, RI     02865-1623
  127.